Skip to content

Conditionally compile contracts instead of deciding at run-time #145229

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: master
Choose a base branch
from

Conversation

dawidl022
Copy link

@dawidl022 dawidl022 commented Aug 10, 2025

The initial implementation of contracts, despite requiring a compiler flag to enable runtime checking of contracts, still compiled contracts into function definitions, even when the compiler flag was disabled. This meant that contracts could not be safely added to functions without breaking optimisations, or even without potentially changing the behaviour of the function. This was blocking the addition of contracts to standard library functions in #136578.

This change guards macro expansion of the built-in contract macros with the contract-checks compiler flag. Additionally, it removes the contract_checks compiler intrinsic that was used to determine whether contract checks should be executed at runtime. Now, when contracts checks are compiled into the body of a function, they will always be executed.

The change is motivated by the following discussion: #144438 (comment)

Contracts tracking issue: #128044

Known limitations:

  • When contract-checks are disabled, contracts will not be parsed or type checked, meaning that they are susceptible to becoming out of sync with the rest of the codebase.

@rustbot
Copy link
Collaborator

rustbot commented Aug 10, 2025

r? @lcnr

rustbot has assigned @lcnr.
They will have a look at your PR within the next two weeks and either review your PR or reassign to another reviewer.

Use r? to explicitly pick a reviewer

@rustbot rustbot added S-waiting-on-review Status: Awaiting review from the assignee but also interested parties. T-compiler Relevant to the compiler team, which will review and decide on the PR/issue. T-libs Relevant to the library team, which will review and decide on the PR/issue. labels Aug 10, 2025
@rustbot
Copy link
Collaborator

rustbot commented Aug 10, 2025

Some changes occurred to the intrinsics. Make sure the CTFE / Miri interpreter
gets adapted for the changes, if necessary.

cc @rust-lang/miri, @RalfJung, @oli-obk, @lcnr

@rust-log-analyzer

This comment has been minimized.

@saethlin
Copy link
Member

This was blocking the addition of contracts to standard library functions in #136578.

Hunh? All I can see in that PR is contract checks changing the optimized MIR of functions which is expected and should be fine. Disabled contract check MIR should be cleaned out as part of lowering to LLVM, or it should be immediately cleaned up by LLVM because it is under the equivalent of an if false.

@dawidl022
Copy link
Author

This was blocking the addition of contracts to standard library functions in #136578.

Hunh? All I can see in that PR is contract checks changing the optimized MIR of functions which is expected and should be fine. Disabled contract check MIR should be cleaned out as part of lowering to LLVM, or it should be immediately cleaned up by LLVM because it is under the equivalent of an if false.

How does one evaluate whether disabled contract check code is indeed cleaned up? You mentioned in #136578 (comment):

I suspect you'll then fail codegen tests, and those may be much more troublesome.

Could you elaborate on this please? Indeed one of the codegen tests (tests/codegen/cross-crate-inlining/leaf-inlining.rs) fails on that branch, and I don't have the expertise to judge what the consequences of that test failure are.

I feel that contracts should not interfere with optimisations of the code in any way, since to me they serve as an executable piece of documentation, comparable to rustdoc tests. Having contracts get in the way of normal code will likely slow down their adoption.

The initial implementation of contracts, despite requiring a
compiler flag to enable runtime checking of contracts, still
compiled contracts into function definitions, even when
the compiler flag was disabled. This meant that contracts
could not be safely added to functions without breaking
optimisations, or even without potentially changing
the behaviour of the function.

This change guards macro expansion of the built-in contract macros
with the contract-checks compiler flag. Additionally, it removes
the contract_checks compiler intrinsic that was used to determine
whether contract checks should be executed at runtime. Now,
when contracts checks are compiled into the body of a function,
they will always be executed.
@dawidl022 dawidl022 force-pushed the contracts/conditional-macros-rebased branch from c6064ad to 8600932 Compare August 12, 2025 08:06
@lcnr
Copy link
Contributor

lcnr commented Aug 12, 2025

I haven't been involved in the contracts work, so it might make sense to reassign this to someone who is more involved in that effort.

I would expect that long term, we definitely want contracts to be type checked even if we don't actually enforce them at runtime, is that correct?

I would also expect that if false in the MIR should get optimized out without negatively impacting other optimizations. If not, this just seems like a generally desirable MIR optimization?

@dawidl022
Copy link
Author

r? @celinval

I would expect that long term, we definitely want contracts to be type checked even if we don't actually enforce them at runtime, is that correct?

Yes, I believe that is the case.

I would also expect that if false in the MIR should get optimized out without negatively impacting other optimizations. If not, this just seems like a generally desirable MIR optimization?

Agreed, it sounds desirable. I'm less sure however about relying on optimisations, when we can simply not compile the contracts when disabled. E.g. I'm not sure what the compile-time penalty might be of optimising out contracts compared to excluding them from compilation in the first place.

@rustbot rustbot assigned celinval and unassigned lcnr Aug 12, 2025
@lcnr
Copy link
Contributor

lcnr commented Aug 12, 2025

E.g. I'm not sure what the compile-time penalty might be of optimising out contracts compared to excluding them from compilation in the first place.

Excluding them from compilation must only happen post MIR borrowck/after analysis as it shouldn't be user-facing, should it not?

At this point removing them has to be a MIR optimization pass, so it can just be a more general "remove if false" pass which runs after const folding

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
S-waiting-on-review Status: Awaiting review from the assignee but also interested parties. T-compiler Relevant to the compiler team, which will review and decide on the PR/issue. T-libs Relevant to the library team, which will review and decide on the PR/issue.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

6 participants